home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / miscellaneous / help / dos / dosman / man / cmp < prev    next >
Encoding:
Text File  |  1996-09-07  |  3.5 KB  |  96 lines
  1.  
  2.  
  3.  
  4.      Cmp(V1.3 ARP Only)               
  5.  
  6.  
  7.      NAME
  8.           Cmp - Compare files and report differences.
  9.  
  10.      SYNOPSIS
  11.           Cmp From With FULL QUICK ALL
  12.  
  13.      DESCRIPTION
  14.             Use Cmp to display differences between binary or text 
  15.         files.  When comparing single files, the return code will 
  16.         be set to WARN if the files do not match. This is useful 
  17.         in scripts with IF statements.  The return code on 
  18.         complex pattern matches with more than one file will 
  19.         always be zero. When specifying directories as either the 
  20.         From or With arguments, you may use a dot which means 
  21.         "current directory".
  22.  
  23.             You can use either C-e (Control E) or C-f (Control F) 
  24.         to abort the comparison of the current files and move on 
  25.         to the next.  This is most useful with multiple input 
  26.         files and the FULL (see below) option.  As usual, a C-c 
  27.         (Control C) will abort the program all together.
  28.  
  29.      INPUT FILES
  30.             You can specify the file or files to be compared 
  31.         quite easily and naturally with Cmp using simple 
  32.         pathnames or wildcard patterns or even directory names. 
  33.         When you specify wildcards and/or directories to be 
  34.         compared, Cmp will compare files with the same names in 
  35.         each directory.  Cmp will not abort if it cannot find the 
  36.         second file, it will simply print an informative message 
  37.         and go on to the next file.  If you need to compare files 
  38.         with different names, then you must specify each name in 
  39.         full as the With name and the From name.  A more detailed 
  40.         explanation follows:
  41.  
  42.             If From is a file, then With may be either a 
  43.         directory or another file.  If a directory is supplied, 
  44.         then Cmp looks for a file with the same name as the From 
  45.         file in that directory:
  46.  
  47.             So, to a compare File with RAD:Dir/File2 
  48.  
  49.               Cmp File RAD:dir/File2  
  50.  
  51.  
  52.             And to compare File with DirName/File
  53.  
  54.               Cmp File DirName   
  55.  
  56.  
  57.             You may also use a wildcard pattern as the From file.  
  58.         In this case, the With name must be a directory.  Cmp 
  59.         expands the wildcard specification and tries to find 
  60.         files with that name in the With directory:
  61.  
  62.             Cmp File RAD:Foo/$?.c DF0:c
  63.  
  64.  
  65.             Finally, you can also use two directory names as the 
  66.         From and With specification. This will compare all the 
  67.         files of the same name in the From directory with all the 
  68.         files of the same name in the With directory:
  69.  
  70.             Cmp Dir1 Dir2
  71.  
  72.  
  73.       OPTIONS
  74.           FULL 
  75.             This will display all points at which the two files 
  76.         differ.  The display is of the form "Offset: Byte1 Byte2" 
  77.         where Offset is in decimal and Byte1 Byte2 are in hex. 
  78.         Use C-e or C-f to move to the next file in the series, or 
  79.         C-c to abort.
  80.  
  81.           QUICK
  82.             The QUICK option will check to see if the two files 
  83.         appear to be identical, by first comparing the date 
  84.         stamps and file lengths, and if these are the same the 
  85.         file comparison is skipped saving some time.
  86.  
  87.           ALL
  88.             If there are subdirectories within the directories 
  89.         you are comparing, the ALL switch will force Cmp to 
  90.         recursively descend these directories, comparing files as 
  91.         appropriate.
  92.  
  93.      NOTE
  94.             This command is new with V1.3 of ARP, it is not 
  95.         available with the Commodore distribution.
  96.